---
title: Changelog
description: Latest updates and announcements.
---

import {
  Changelog,
  ChangelogItem,
  ChangelogItemTitle,
  ChangelogItemDescription,
  ChangelogItemVersion,
  ChangelogItemList,
} from '@/components/docs/changelog';

<Changelog>

<ChangelogItem date="2025-11-30">
  <ChangelogItemVersion>

## 1.0.26

  </ChangelogItemVersion>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New `MotionCarousel` community component by [arhamkhnz](https://github.com/arhamkhnz).

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-11-18">
  <ChangelogItemVersion>

## 1.0.25

  </ChangelogItemVersion>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New `RadialMenu` community component by [arhamkhnz](https://github.com/arhamkhnz).

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-11-17">
  <ChangelogItemVersion>

## 1.0.24

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New Base UI `PreviewLinkCard` primitive.
- New Radix UI `PreviewLinkCard` primitive.
- Update of the Base UI `PreviewCard` primitive to add the `followCursor` and `followCursorSpringOptions` props.
- Update of the Radix UI `HoverCard` primitive to add the `followCursor` and `followCursorSpringOptions` props.
- Update of the Radix UI `Tooltip` primitive to add the `followCursor` and `followCursorSpringOptions` props.
- Update of the Base UI `Tooltip` primitive to add the `followCursor` and `followCursorSpringOptions` props.
- Fix the `SheetContent` primitive.

</ChangelogItemDescription>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New Base UI `PreviewLinkCard` component.
- New Radix UI `PreviewLinkCard` component.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-11-13">
  <ChangelogItemVersion>

## 1.0.23

  </ChangelogItemVersion>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New `FlipCard` community component by [DivyashriRavichandran](https://github.com/DivyashriRavichandran).

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-11-10">
  <ChangelogItemVersion>

## 1.0.22

  </ChangelogItemVersion>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New `RadialIntro` community component by [arhamkhnz](https://github.com/arhamkhnz).

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-11-05">
  <ChangelogItemVersion>

## 1.0.21

  </ChangelogItemVersion>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New `GravityStars` background component.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-28">
  <ChangelogItemVersion>

## 1.0.20

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New `ImageZoom` effect primitive.
- Update of the Radix UI `Accordion` primitive to improve the animation.
- Update of the Radix UI `Collapsible` primitive to improve the animation.
- Update of the Headless UI `Disclosure` primitive to improve the animation.
- Update of the Base UI `Accordion` primitive to improve the animation.
- Update of the Base UI `Collapsible` primitive to improve the animation.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-27">
  <ChangelogItemVersion>

## 1.0.19

  </ChangelogItemVersion>

<ChangelogItemTitle>Icons</ChangelogItemTitle>

<ChangelogItemDescription>

- Added **4 new icons** by [Luca Félix](https://github.com/flixlix):
  - `gallery-horizontal`
  - `gallery-horizontal-end`
  - `gallery-vertical`
  - `gallery-vertical-end`

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-27">
  <ChangelogItemVersion>

## 1.0.18

  </ChangelogItemVersion>

<ChangelogItemTitle>Icons</ChangelogItemTitle>

<ChangelogItemDescription>

- Added **12 new icons** by [Matthew Smith](https://github.com/Matthew-Smith):
  - `phone-call`
  - `link-2`
  - `sparkle`
  - `sparkles`
  - `panel-bottom-close`
  - `panel-bottom-open`
  - `panel-left-close`
  - `panel-left-open`
  - `panel-right-close`
  - `panel-right-open`
  - `panel-top-close`
  - `panel-top-open`

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-21">
  <ChangelogItemVersion>

## 1.0.17

  </ChangelogItemVersion>

<ChangelogItemTitle>Icons</ChangelogItemTitle>

<ChangelogItemDescription>

- Added **4 new icon** by [Matthew Smith](https://github.com/Matthew-Smith):
  - `between-horizontal-end`
  - `between-horizontal-start`
  - `between-vertical-end`
  - `between-vertical-start`

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-21">
  <ChangelogItemVersion>

## 1.0.16

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New Base UI `Menu` primitive.
- Update of the Radix UI `DropdownMenu` primitive to fix the keyboard navigation.
- Update of the Base UI primitives for version 4 of the beta.

</ChangelogItemDescription>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New Base UI `Menu` component.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-18">
  <ChangelogItemVersion>

## 1.0.15

  </ChangelogItemVersion>

<ChangelogItemTitle>Icons</ChangelogItemTitle>

<ChangelogItemDescription>

- Added **1 new icon** by [Matthew Smith](https://github.com/Matthew-Smith):
  - `arrow-up-down`

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-13">
  <ChangelogItemVersion>

## 1.0.14

  </ChangelogItemVersion>

<ChangelogItemTitle>Icons</ChangelogItemTitle>

<ChangelogItemDescription>

- Added **5 new icons**:
  - `circuit-board`
  - `clipboard`
  - `clipboard-check`
  - `clipboard-list`
  - `list`

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-04">
  <ChangelogItemVersion>

## 1.0.13

  </ChangelogItemVersion>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New `RadialNav` community component by [@arhamkhnz](https://github.com/arhamkhnz).

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-04">
  <ChangelogItemVersion>

## 1.0.12

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New `Tilt` effect primitive.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-10-02">
  <ChangelogItemVersion>

## 1.0.11

  </ChangelogItemVersion>

<ChangelogItemTitle>Icons</ChangelogItemTitle>

<ChangelogItemDescription>

- Added **12 new icons**:
  - `fan`
  - `axis-3d`
  - `blend`
  - `signal`
  - `signal-high`
  - `signal-medium`
  - `signal-low`
  - `signal-zero`
  - `wifi-zero`
  - `scissors`
  - `scissors-line-dashed`
  - `route`

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-26">
  <ChangelogItemVersion>

## 1.0.10

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New Base UI `Radio` primitive.

</ChangelogItemDescription>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New Base UI `Radio` component.

</ChangelogItemDescription>

<ChangelogItemTitle>Docs</ChangelogItemTitle>

<ChangelogItemDescription>

The entire documentation design has been revised to give it a more modern look and make it more user-friendly.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-24">
  <ChangelogItemVersion>

## 1.0.9

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New `Shine` effect primitive.

</ChangelogItemDescription>

<ChangelogItemTitle>Icons</ChangelogItemTitle>

<ChangelogItemDescription>

- Bug fixes on the `AnimateIcon` component.
- Removed the `onAnimateChange`, `onAnimateStart`, and `onAnimateEnd` events, which added complexity and caused many bugs for very limited utility.
- Added the `completeOnStop` property.
- Added a new animation for all "off" icons.
- Added **15 new icons**:
  - `blocks`
  - `frame`
  - `plug-zap`
  - `radio`
  - `radio-tower`
  - `nfc`
  - `paperclip`
  - `unplug`
  - `ev-charger`
  - `link`
  - `sliders-horizontal`
  - `sliders-vertical`
  - `equal-not`
  - `circle-check-big`
  - `router`

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-18">
  <ChangelogItemVersion>

## 1.0.8

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New `Click` effect primitive.
- Update the `SlidingNumber` and `CountingNumber` primitives to add the `initiallyStable` prop.
- Remove the `Counter` primitive and component.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-16">
  <ChangelogItemVersion>

## 1.0.7

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives and Components</ChangelogItemTitle>

<ChangelogItemDescription>

**Radix UI**:

- New `AlertDialog` primitive and component.

**Base UI**:

- New `AlertDialog` primitive and component.
- New `Dialog` primitive and component.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-14">

  <ChangelogItemVersion>

## 1.0.6

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- For Radix UI, Base UI, and Headless UI Tabs, we have added a props `mode`. This allows you to adjust the animation for resizing tab content according to your needs.
- New `MorphingText` primitive.

</ChangelogItemDescription>

<ChangelogItemTitle>Accessibility</ChangelogItemTitle>

<ChangelogItemDescription>

We have added [documentation for accessibility with Animate UI](./accessibility).

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-13">
  <ChangelogItemVersion>

## 1.0.5

  </ChangelogItemVersion>

<ChangelogItemTitle>Icons</ChangelogItemTitle>

<ChangelogItemDescription>

- Added **10 new icons**:
  - `check`
  - `check-check`
  - `check-line`
  - `circle-check`
  - `clapperboard`
  - `crop`
  - `lock`
  - `lock-keyhole`
  - `lock-open`
  - `lock-keyhole-open`

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-12">
  <ChangelogItemVersion>

## 1.0.4

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New `AutoHeight` effect primitive.
- Update of the Animate UI `Tabs` primitive.
- Update of the Base UI `Tabs` primitive.
- Update of the Radix UI `Tabs` primitive.
- Update of the Headless UI `Tabs` primitive.

This update has made the auto-height of tables more fluid and added the `AutoHeight` effect.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-11">
  <ChangelogItemVersion>

## 1.0.3

  </ChangelogItemVersion>

<ChangelogItemTitle>Icons</ChangelogItemTitle>

<ChangelogItemDescription>

- Update of the `AnimateIcon` component, notably for the `loop` and `loopDelay` props, but also to fix some bugs and add an `initialOnAnimateEnd` prop.
- Added **17 new icons**:
  - `cloud-drizzle`
  - `cloud-hail`
  - `cloud-lightning`
  - `cloud-moon`
  - `cloud-moon-rain`
  - `cloud-rain`
  - `cloud-rain-wind`
  - `cloud-snow`
  - `cloud-sun`
  - `cloud-sun-rain`
  - `moon`
  - `moon-star`
  - `orbit`
  - `sun`
  - `sun-dim`
  - `sun-medium`
  - `sun-moon`

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-09">
  <ChangelogItemVersion>

## 1.0.2

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New Base UI `Tabs` primitive.

</ChangelogItemDescription>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New Base UI `Tabs` component based on the `Tabs` primitive.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem date="2025-09-08">
  <ChangelogItemVersion>

## 1.0.1

  </ChangelogItemVersion>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

- New `ThemeToggler` effect primitive.

</ChangelogItemDescription>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

- New `ThemeTogglerButton` button component based on the `ThemeToggler` effect primitive.

</ChangelogItemDescription>

</ChangelogItem>

<ChangelogItem major date="2025-09-07">
  <ChangelogItemVersion>

## 1.0.0

  </ChangelogItemVersion>
  
<ChangelogItemDescription>

**Animate UI** is no longer in beta.

In order to make Animate UI more accessible and simpler, we are introducing a new organization.
Animate UI is now divided into three parts:

- **Primitives**: Primary components, animated but without style.
- **Components**: Ready-to-use components styled with Tailwind CSS.
- **Icons**: Animated icons based on Lucide Icons.

**All components have been reworked** to be improved and optimized.

<Callout type="info">
  **Note:** This update contains significant changes compared to the last beta
  version. As Animate UI is no longer in beta, this structure should remain
  stable over time. We recommend that you use only the components in this new
  version.
</Callout>

</ChangelogItemDescription>

<ChangelogItemTitle>Primitives</ChangelogItemTitle>

<ChangelogItemDescription>

**Animate UI**:

- New `AvatarGroup` primitive.
- New `CodeBlock` primitive.
- New `Counter` primitive.
- New `Cursor` primitive.
- New `GithubStars` primitive.
- New `MotionGrid` primitive.
- New `PinnedList` primitive.
- New `ScrollProgress` primitive.
- New `Slot` primitive.
- New `Spring` primitive.
- New `Tabs` primitive.
- New `Tooltip` primitive.

**Radix UI**:

- New `Accordion` primitive.
- New `Checkbox` primitive.
- New `Collapsible` primitive.
- New `Dialog` primitive.
- New `DropdownMenu` primitive.
- New `Files` primitive.
- New `HoverCard` primitive.
- New `Popover` primitive.
- New `Progress` primitive.
- New `RadioGroup` primitive.
- New `Sheet` primitive.
- New `Sidebar` primitive.
- New `Switch` primitive.
- New `Tabs` primitive.
- New `Toggle` primitive.
- New `ToggleGroup` primitive.
- New `Tooltip` primitive.

**Base UI**:

- New `Accordion` primitive.
- New `Checkbox` primitive.
- New `Collapsible` primitive.
- New `Files` primitive.
- New `Popover` primitive.
- New `PreviewCard` primitive.
- New `Progress` primitive.
- New `Switch` primitive.
- New `Toggle` primitive.
- New `ToggleGroup` primitive.
- New `Tooltip` primitive.

**Headless UI**:

- New `Checkbox` primitive.
- New `Dialog` primitive.
- New `Disclosure` primitive.
- New `Popover` primitive.
- New `Switch` primitive.
- New `Tabs` primitive.

**Buttons**:

- New `Button` primitive.
- New `FlipButton` primitive.
- New `LiquidButton` primitive.
- New `RippleButton` primitive.

**Texts**:

- New `ScrollingNumber` primitive.

_All other texts have been updated to be optimized and fix some bugs._

**Effects**:

- New `Blur` primitive.
- New `Fade` primitive.
- New `Particles` primitive.
- New `Slide` primitive.
- New `Zoom` primitive.

_All other effects have been updated to be optimized and fix some bugs._

</ChangelogItemDescription>

<ChangelogItemTitle>Components</ChangelogItemTitle>

<ChangelogItemDescription>

**Animate UI**:

_All components have been reworked to use the new animated primitives._

**Radix UI**:

- New `Toggle` component.

_All other components have been reworked to use the new animated primitives._

**Base UI**:

- New `Files` component.
- New `Toggle` component.

_All other components have been reworked to use the new animated primitives._

**Headless UI**:

_All components have been reworked to use the new animated primitives._

**Buttons**:

- New `Button` component.

_All other components have been reworked to use the new animated primitives._

**Backgrounds**:

_No changes to backgrounds._

**Community**:

The new community category contains animated components contributed by the community. Unlike other Animate UI components, they aren’t required to use our primitives, so their APIs may vary and some may offer limited configuration (few or no props).

The goal is to make it easy for anyone to publish and share animated components with the community.

<ChangelogItemTitle>Icons</ChangelogItemTitle>

The `AnimateIcon` wrapper has been updated to fix some bugs and add 4 new props:

- `animateOnView`
- `animateOnViewMargin`
- `animateOnViewOnce`
- `delay`

There are **24 new icons**:

- `accessibility`
- `airplay`
- `binary`
- `terminal`
- `badge-check`
- `cast`
- `cctv`
- `chart-bar`
- `chart-bar-increasing`
- `chart-bar-decreasing`
- `chart-column`
- `chart-column-increasing`
- `chart-column-decreasing`
- `chart-line`
- `chart-no-axes-column`
- `chart-no-axes-column-increasing`
- `chart-no-axes-column-decreasing`
- `chart-scatter`
- `chart-spline`
- `contrast`
- `cross`
- `ellipsis`
- `ellipsis-vertical`
- `party-popper`

</ChangelogItemDescription>

<ChangelogItemTitle>Changelog</ChangelogItemTitle>

<ChangelogItemDescription>

Now, all changes will be detailed month by month and version by version on this page for greater transparency.

</ChangelogItemDescription>

<ChangelogItemTitle>Roadmap</ChangelogItemTitle>

<ChangelogItemDescription>

We have added a roadmap page to give you more visibility into the future of Animate UI. This may evolve over time.

See the [roadmap page here](./roadmap).

</ChangelogItemDescription>

<ChangelogItemTitle>Shadcn CLI V3</ChangelogItemTitle>

<ChangelogItemDescription>

We have updated our installation method to use the new feature of CLI shadcn/ui version 3. Now, to install a component, you can use `@animate-ui/[type]-[category]-[name]`. For example, to install the Base UI accordion primitive, you can use `@animate-ui/primitives-base-accordion`.

See the [getting started guide here](./installation).

</ChangelogItemDescription>

<ChangelogItemTitle>MCP</ChangelogItemTitle>

<ChangelogItemDescription>

We have updated the MCP page to show you how to use the MCP shadcn/ui with Animate UI.

See the [MCP page here](./mcp).

</ChangelogItemDescription>

<ChangelogItemTitle>Other animated distributions</ChangelogItemTitle>

<ChangelogItemDescription>

We have added a page to show you other animated distributions that you can use with Animate UI.

See the [other animated distributions page here](./other-animated-distributions).

</ChangelogItemDescription>

</ChangelogItem>

</Changelog>
